home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / comm2 / tfbbs.lha / TeleFun_BBS.doc < prev    next >
Text File  |  1995-08-09  |  48KB  |  993 lines

  1. TeleFun_BBS User Manual
  2. -----------------------
  3.  
  4. TeleFun_BBS, TeleFun_Setup, TeleFun_UserEdit, and TeleFun_LibEdit are
  5. copyright 1993,1994,1995 by Lawrence McClafferty.
  6. These files may be freely distributed provided no charge is made beyond
  7. the normal charge for disk distribution (maximum $5). Any inclusion in
  8. disk clubs, etc. must be ok'ed with the author first (just so I can keep
  9. track of where it is going so updates can be provided).
  10.  
  11. TeleFun_BBS is being released as shareware with a $50 (US or Canadian,
  12. whichever is easiest for you) registration fee. Any updates are free and
  13. may be obtained from The Black Box BBS at (613) 394-0651.
  14.  
  15. TeleFun_BBS has been run on the following Amiga systems with no problems at
  16. all: Amiga 500
  17.      Amiga 2000
  18.      Amiga 3000
  19. If you find that you can get it running on another Amiga system then please
  20. let me know so I will know for sure that it runs ok.
  21.  
  22. Any typo errors that appear in this manual have been placed here on purpose.
  23. Some people like looking for stuff like that so I like to keep them happy.;)
  24.  
  25. Getting Started
  26. ---------------
  27. TeleFun_BBS has been designed to be very simple to operate and maintain. If
  28. you follow all steps given then you should have no problems. If you do have
  29. problems then let me know. I will try to make it even easier to use if people
  30. throw suggestions at me.
  31.  
  32. Step 1: You must first have used the TeleFun_Setup program to get all the
  33.         files and areas created for use. All files must be in their proper
  34.         directories as follows:
  35.  
  36.         TeleFun_BBS - put this anywhere you want. It is only required to get
  37.                       the BBS started.
  38.         TeleFun_Data - in the s directory (will be created by TeleFun_Setup)
  39.         TeleFun_Bull - in the directory specified as the BBS directory in
  40.                        the file TeleFun_Data (will be created in the proper
  41.                        directory by TeleFun_Setup)
  42.         TeleFun_Mail - same as TeleFun_Bull (will be created in the proper
  43.                        directory by TeleFun_Setup)
  44.         TeleFun_Libs - same as TeleFun_Bull (will be created in the proper
  45.                        directory by TeleFun_Setup)
  46.         chatsound - in the BBS directory
  47.         all .ansi and .text files - in the BBS directory
  48.         XPRD or XPRD.030 - in the BBS directory **SEE NOTE LATER IN MANUAL
  49.         sound - in the c directory
  50.         all the xpr?????.library files - in the libs directory
  51.  
  52. Step 2: Double-click on the TeleFun_BBS icon. You may also run TeleFun_BBS
  53.         from the CLI by typing in the name TeleFun_BBS but you should first
  54.         ensure your stack is set to 40000 or greater just to be on the safe
  55.         side. If you get no screen coming up then please recheck all the
  56.         data you entered in the TeleFun_Setup program.
  57.  
  58. Step 3: When you are asked if you want the modem disabled you can hit either
  59.         Y for yes or N for no. No would be used for folks who wish to give
  60.         the BBS a checkout before they actually run it. No data whatsoever
  61.         will be output to the serial port in this mode.
  62.         
  63.         NOTE: I have not tried this next bit out yet but it may work - you may
  64.               have the BBS running and then load the BBS again but this time
  65.               respond N to the modem prompt. This should allow you to get on
  66.               the BBS and do stuff without the need for tying up the system.
  67.               Like I say though, I don't know if this will work properly yet
  68.               or not. This WILL be how TeleFun_BBS will operate in a multi-
  69.               line system later on if I decide to add that feature.
  70.  
  71.         You may also allow the timeout to occur. After 10 seconds the BBS will
  72.         automatically enable the serial port. This has been installed to allow
  73.         a Sysop to start the BBS from their startup-sequence if their system
  74.         crashes or a power failure occurs.
  75.  
  76. Step 4: Start using the system.
  77.  
  78. As you can see, it is very easy to get this beast up and running. The next
  79. section will give a brief outline of what the various features are.
  80.  
  81. Using TeleFun_BBS-
  82. -----------------
  83. Once you have TeleFun_BBS enabled, you will be presented with two windows.
  84. The top window is entitled "TeleFun BBS - Caller Status". This is where all
  85. information about the caller who is online will appear. The lower window is
  86. the BBS itself. Here you will see some of the last callers and info on what
  87. they did while online. The following format is used:
  88.  
  89.  NUM : the user's account number
  90. NAME : the user's board name
  91.  DAY : the month/day they called
  92. TIME : the time they called
  93. USED : # of minutes they stayed online
  94.  UPL : # of files they uploaded
  95.  DNL : # of files they downloaded
  96. PRMSG: # of private messages they posted
  97. MAIL : # of public pieces of mail they posted
  98.  CHT : flag showing whether they tried to chat with you or not
  99. BAUD : baud rate they connected at (add 2 zeros to the number)
  100.  
  101. Below this caller info you will see some BBS statistical info. This data is:
  102.  
  103. Recent Uploads  : # of files uploaded since Sysop's last call
  104. Recent Downloads: # of files downloaded since Sysop's last call
  105. Recent Connects : # of connected calls since Sysop's last call
  106. Recent No Conect: # of unconnected calls (no carrier) since Sysop's last call
  107. Unvalidated User: # of users currently unvalidated on the system
  108. Recent Sysop Msg: # of pieces of mail addressed to Sysop and not read yet
  109. Chat Attempts   : # of times people have tried to chat with Sysop
  110. Total Uploads   : grand total of all files uploaded
  111. Total Downloads : grand total of all files downloaded
  112. Total Connects  : total number of callers
  113. Total # Users   : grand total of users on system
  114. Total Pub. Msg  : grand total of public messages written on system
  115. Total Priv Msg  : grand total of private messages written on system
  116. Last Midmaint   : date last midnight maintenance was run
  117.  
  118. Now the system is just sitting there waiting for a caller to show up.
  119.  
  120. Call Coming In-
  121. --------------
  122. If you have the voice enabled you will hear this when the modem detects that
  123. the line is ringing. The system will pick up the phone and start checking for
  124. a carrier. If a carrier is not detected within 45 seconds, the system will
  125. hang up and wait for another ring. If the carrier is detected then the system
  126. will complete its connection.
  127.  
  128. We Have A Connection-
  129. --------------------
  130. Once the connection is established you will hear this (if you have the voice
  131. enabled). The caller will then be asked to enter their information. At this
  132. point they may use their account number, real name, board name, or zero if
  133. they are a new user. If it is not a new user then they will be asked for their
  134. password. The password will be blanked out with "*" on all output devices so
  135. that no one can see it. If the password is incorrect then a second attempt
  136. will be made to get the password. A total of three attempts at the password is
  137. allowed and then the system will go back to asking the user what their name is
  138. again just in case the person had bad data transmitted the first time. A total
  139. of three attempts will be made to get the caller's name with three attempts at
  140. the password each time. If all attempts are bad then the system will hang up
  141. and wait for another caller.
  142. After this, the usual BBS data of date, time, last call date, etc. will be
  143. shown to the user.
  144. The caller will then be presented with the Welcome.Text message that you have
  145. on disk. If that message is not present then a warning message will come up
  146. stating it doesn't exist.
  147.  
  148. Main Menu-
  149. ---------
  150. A - Account Stats      B - Bulletins
  151. C - Chat With Sysop    F - Fun'n Games
  152. G - Goodbye            H - High Scores
  153. I - System Info        K - Set Graphics
  154. L - Libraries          M - Mailbag
  155. Q - Quick Menu         S - System Stats
  156. T - Time Stats         U - User List
  157. V - Caller Log         ? - Reprint This Menu
  158. J - Join System
  159. X - Sysop Menu
  160. NOTE - Sysop_News is presnt
  161. NOTE - TeleFun_Uploads is present
  162. NOTE - xprd.log is present
  163.  
  164. Above will be seen everything that could possibly come up in the main menu.
  165. You may design your own menus as well. For ANSI users you would have a menu
  166. saved to disk called mainmenu.ansi. A basic ASCII menu would have the name
  167. mainmenu.text. Each item will be covered below in alphabetical order.
  168.  
  169. A - Account Stats-
  170. -----------------
  171. This is where a user can view/change the info in their account. If certain
  172. items are changed then their account will revert to the NEW USER level so that
  173. the Sysop may verify the new information first.
  174.  
  175. B - Bulletins-
  176. -------------
  177. This is where the bulletins are listed.
  178.  
  179. C - Chat With Sysop-
  180. -------------------
  181. The caller will be prompted for a reason as to why they want to chat. Once the
  182. reason has been entered then a "** CHAT **" will appear in the Caller Status
  183. window and the title bar of that window will change to what the reason for the
  184. chat is. If the reason is less than three characters long the chat attempt
  185. will be aborted. Ensure that you have the file "sound" in your c directory and
  186. the file "chatsound" in your BBS directory. If not then you will not here the
  187. chat request call. The file "chatsound" can be any IFF sound that can be
  188. played with the "sound" program. While you are in the chat mode you can turn
  189. your printer on and off so you can capture stuff that your user sends. This is
  190. automatically turned off when you exit chat mode so you need not worry about
  191. turning it off yourself.
  192.  
  193. F - Fun'n Games-
  194. ---------------
  195. This is where the online games go. There are 5 games coded into TeleFun_BBS as
  196. of this writing. This is to ensure that at least a few games are present.
  197. Other games are currently being worked on but they will be external games. If
  198. enough requests are received, I may even try my hand at getting some of the
  199. other BBS program games to work through an interface of some sort. The 5 games
  200. that are coded into TeleFun_BBS are played for points. This is where users can
  201. try to beat each other into the TOP 20 hall of fame. The games included are:
  202.  
  203.        Jujitsu - play against the computer bidding for cards
  204.        Jackpot - 3 daily tries at guessing the number between 1 and 1000
  205.        Hi Roller - roll the dice and try to get over 36 in 5 rolls
  206.        Slot Machine - average one-armed-bandit type game
  207.        Black Jack - play 21 against the computer
  208.  
  209. Other games will be developed as time goes on. These other games will NOT be
  210. hard coded into the BBS program itself. There will be an interface to handle
  211. them. More info to follow on these games at a later date.
  212.  
  213. G - Goodbye-
  214. -----------
  215. This speaks for itself. The computer logs the user off and sorts a few things
  216. out and then waits for the next caller. The serial port is actuall shut right
  217. down at this point and then reopened. This is to help ensure no obscure bits
  218. of data lock up the modem for some reason.
  219.  
  220. H - High Scores-
  221. ---------------
  222. The top 20 users' scores are displayed from here.
  223.  
  224. I - System Info-
  225. ---------------
  226. This will display the text file System_Info that the Sysop has created to the
  227. user. In this file it is a good idea to list the things that make your system
  228. tick. Things such as computer type, modem type, drive space, and so on.
  229.  
  230. J - Join System-
  231. ---------------
  232. This option is only displayed for new users who do not have an account yet.
  233. When this option is picked, the new user will be requested for all of their
  234. info which will be saved into an account. That user will then go from a guest
  235. status to an invalidated user status.
  236.  
  237. K - Set Graphics-
  238. ----------------
  239. From here, the user can toggle their ANSI and/or color capabilities on & off.
  240. I was going to include this section in the Account Stats area but I figured
  241. since it was something that many people toggle on and off depending on what
  242. terminal program they are using, that I would have it in its own section.
  243.  
  244. L - Libraries-
  245. -------------
  246. This will allow the user into the Library Main Menu. This area will only show
  247. a list of the libraries available and from here the user will pick the one
  248. they want to go into. If their security status is not valid for the library
  249. they have chosen, they can not enter that library. The features available in
  250. the libraries are as follows:
  251.  
  252. A - Abort To Library Menu - the user can go back to select a new library
  253.                             without the need of going all the way back to the
  254.                             BBS Main Menu.
  255.  
  256. B - Abort To BBS Main Menu - takes the user right back to the BBS main menu.
  257.  
  258. D - Download Marked Files - allows the user to download any files marked for
  259.                             batch download.
  260.  
  261. E - Edit Batch List - allows the user to delete files from their batch list.
  262.  
  263. L - Long List Of Files - shows all info about the file(s) selected. This is
  264.                          also the list that the user will select to mark or
  265.                          download files from.
  266.  
  267. N - New Files - view only new files in the library.
  268.  
  269. Q - Quick Menu - same as from Main Menu.
  270.  
  271. S - Short List of Files - just like it says. Can not mark or dload from here.
  272.  
  273. U - Upload A File - upload a file to that library.
  274.  
  275. Y - Your Library Statistics - shows the user their file transfer ratio.
  276.  
  277. ? - Reprint This Menu - same as for Main Menu.
  278.  
  279. C - Check number of files in this library - just like the name says.
  280.  
  281. F - Find Unvalidated Files - just like the name says.
  282.  
  283. M - Mailbag-
  284. -----------
  285. This works just like the Library option except it is for the message bases.
  286. The options are pretty self-explanatory so I won't bother going into them in
  287. the manual unless someone asks me to include them.
  288.  
  289. Q - Quick Menu-
  290. --------------
  291. For users who prefer the "expert menu" type of screen output (ie. no full menu
  292. but just a list of letters) then this is where they can toggle that option. 
  293. The choice they make will be written to their account so it will always be
  294. remembered until the user toggles it again.
  295.  
  296. S - System Stats-
  297. ----------------
  298. This will show the caller a list of system statistics such as the number of
  299. callers, message written, and so on.
  300.  
  301. T - Time Stats-
  302. --------------
  303. The caller will be shown just about everything involving their account and the
  304. time. This includes the current time, logon time, last call time, time that
  305. their account will reset back to full time, and so on.
  306.  
  307. U - User List-
  308. -------------
  309. This displays a list of all user accounts. It shows the board name, the city,
  310. and the last call time for each user.
  311.  
  312. V - Caller Log-
  313. --------------
  314. A log of callers is maintained for the previous 7 days of running the BBS. A
  315. caller can select which log they which to view (current, 1 day ago, 2 days ago
  316. and so on).
  317.  
  318. ? - Reprint This Menu-
  319. ---------------------
  320. If a user has toggled the quick menu on and they forget what one letter meant
  321. they can hit the ? to get a one-time view of the menu again. This will not
  322. toggle the quick menu flag in their account.
  323.  
  324. X - Sysop Menu-
  325. --------------
  326. The Sysop menu contains a few bits of usefull info for Sysop's eyes only. When
  327. selected, they Sysop gets a menu showing:
  328.  
  329. A - User Account Editor
  330. C - Check Number Of Users
  331. D - AmigaDOS
  332. E - Text File Editor (not currently working)
  333. K - Kill Sysop_News File
  334. L - Read Sysop_News File
  335. R - Return To BBS
  336. S - Search For Unvalidated Users
  337. T - Kill TeleFun_Uploads File
  338. U - Read TeleFun_Uploads File
  339. V - Voice Options
  340. W - Kill xprd.log File
  341. X - Read xprd.log File
  342.  
  343. Most of these are self-explanatory but here is what they do:
  344.  
  345. A - User Account Editor - edit user's account while online. This is good for
  346.                           when the Sysop is at a remote location but it is
  347.                           faster and easier to use the TeleFun_UserEdit prg.
  348.  
  349. C - Check Number Of Users - looks through user accounts to verify the number
  350.                             of users you have for the System Stats file.
  351.  
  352. D - AmigaDOS - enables access to AmigaDOS while online. For security purposes
  353.                the FORMAT command has been disabled.
  354.  
  355. E - Text File Editor - if you wish to edit a text file while online. This
  356.                        feature is not currently working in TeleFun_BBS v1.0
  357.                        but I hope to have it in by the time v2.0 gets out.
  358.  
  359. K - Kill Sysop_News File | the Sysop_News file informs the Sysop of things
  360. L - Read Sysop_News File |-such as full msg bases, full libraries, improper
  361.                          | logoffs, and some other stuff. Options K and L
  362.                            allow the Sysop to read that file online or delete
  363.                            it from disk.
  364.  
  365. R - Return To BBS - get out of Sysop Menu mode.
  366.  
  367. S - Search For Unvalidated Users - so the Sysop doesn't need to keep track of
  368.                                    a new user's account number, this option
  369.                                    will go through and find them for you. It
  370.                                    will also update the number of invalidated
  371.                                    users for the System Stats file.
  372.  
  373. T - Kill TeleFun_Uploads File |
  374. U - Read TeleFun_Uploads File |- the TeleFun_Uploads file keeps track of what
  375.                               |  was uploaded where and by who. The Sysop can
  376.                                  read the file online or delete it from disk.
  377.  
  378. V - Voice Options - you can alter the spots where the computer speaks. The
  379.                     changes will not affect the TeleFun_Data file though. To
  380.                     make the changes permanent you must change the number in
  381.                     the TeleFun_Data file as well.
  382.  
  383. W - Kill xprd.log File | the xprd.log file is the file created by XPRD when
  384. X - Read xprd.log File |-it is run. It will show how the file transfer was
  385.                        | progressing throughout its time.
  386.  
  387. At the current time, the three files Sysop_News, TeleFun_Uploads, and
  388. xprd.log will be written out to disk. If enough requests come in then I will
  389. put these in as a Sysop's option as to whether they get written out or not.
  390.  
  391. Well, that about covers the overview of all the main points. If there is any
  392. area that you wish to see more developed in this manual then please let me
  393. know and I will add it in.
  394.  
  395. Other Notes:
  396. -----------
  397. Libraries - files in the library can be saved as:
  398.              a) free file - no affect on user's account
  399.              b) regular - size of file and increment of one added to account
  400.              c) free/password protect - same as "a" but password required
  401.              d) regular/password protect - same as "b" but password required
  402.           - user with security clearance can edit a few things about the file
  403.           - uploader can password protect a file but Sysop can see password
  404.           - the R option will show a list of the last uploads. This list will
  405.             contain only the last 50 uploads (or up to the last 50).
  406.  
  407. Special XPRD notes - you will see that there are two XPRD files included with
  408.                      TeleFun BBS. They are XPRD and XPRD.030. If you are
  409.                      running an Amiga with a 68000 then use the XPRD file. If
  410.                      you are using an accelerator such as the 68030 then you
  411.                      MUST use the XPRD.030 file. Rename it as XPRD and place
  412.                      it in the BBS directory. Either way, you MUST have a file
  413.                      called XPRD in the BBS directory.
  414.  
  415. Messages - hitting "G" from the mailbag menu will do a global new read of all
  416.            message bases user has access to.
  417.          - hitting "C" from the mailbag menu will do a global search of all
  418.            mail addressed to the user and tells if it is old or new mail.
  419.  
  420. Text Files Required:
  421. -------------------
  422. Here is a list of files that you can create yourself to go along with the BBS.
  423. Not all these files are a MUST HAVE. The .ansi and .text menu lists are for
  424. your choice. If you don't use them then the BBS will use default menus. The
  425. other files will report an error if they are not present but this error will
  426. NOT crash the BBS. Any of these files that you create must be located in the
  427. directory specified in the TeleFun_Data file as your BBS directory unless
  428. otherwise stated.
  429.  ****************************************************************************
  430. Welcome.Text - welcoming screen when user first logs on
  431.  ****************************************************************************
  432. mainmenu.ansi - ANSI screen of the BBS main menu
  433.  ****************************************************************************
  434. mainmenu.text - plain ASCII screen of the BBS main menu
  435.  ****************************************************************************
  436. libmenu1.ansi - ANSI screen of main library menu (list of libraries)
  437.  ****************************************************************************
  438. libmenu1.text - ASCII screen of main library menu (list of libraries)
  439.  ****************************************************************************
  440. libmenu2.ansi - ANSI screen of library menu for library entered
  441.  ****************************************************************************
  442. libmenu2.text - ASCII screen of library menu for library entered
  443.  ****************************************************************************
  444. mailmenu1.ansi - ANSI screen of mailbag menu (list of message bases)
  445.  ****************************************************************************
  446. mailmenu1.text - ASCII screen of mailbag menu (list of message bases)
  447.  ****************************************************************************
  448. mailmenu2.ansi - ANSI screen of message base menu for base entered
  449.  ****************************************************************************
  450. mailmenu2.text - ASCII screen of message base menu for base entered
  451.  ****************************************************************************
  452. Goodbye.Text - message shown to user when they log off
  453.  ****************************************************************************
  454. NewUser.Text - message shown to user when they hit J for Join
  455.  ****************************************************************************
  456. AfterJoin.Text - message shown to user after they have joined
  457.  ****************************************************************************
  458. bullmenu.ansi - ANSI screen of bulletins menu (list of bulletins)
  459.  ****************************************************************************
  460. bullmenu.text - ASCII screen of bulletin menu (list of bulletins)
  461.  ****************************************************************************
  462. chatter.text - message shown to user when they select C for Chat
  463.  ****************************************************************************
  464. System_Info - message shown to user when they select S for System Info
  465.  ****************************************************************************
  466. pay.txt - message shown to user who is all paid up
  467.         - this is only required if you are running a pay BBS
  468.  ****************************************************************************
  469. nopay.txt - message shown to user who has not paid
  470.           - this is only required if you are running a pay BBS
  471.  ****************************************************************************
  472. midmaint - this file is used for running extra things at the midnight
  473.            maintenance (ie. reset your clock, copy USER.DATA file to
  474.            someplace to keep a backup of it, etc.).
  475.  
  476. Example:
  477.  
  478. setclock load
  479. copy dh1:tfbbs/USER.DATA dh0:BBS-Backups
  480. copy dh1:tfbbs/TeleFun_Stats dh0:BBS-Backups
  481.  ****************************************************************************
  482. arch.end - list of file endings allowed for file uploads (MUST HAVE)
  483.          - this MUST follow the format shown here (example of mine)
  484.  
  485. 5        }the top number tells the BBS how many endings there are. If you
  486. .LHA     }use 3 then only the first 3 endings have any effect so make sure
  487. .LZH     }you put the proper number in here. DO NOT put anything after each
  488. .GIF     }of the endings. See the arch.end file included if this is still
  489. .SDA     }not very clear.
  490. .JPG     }
  491.  ****************************************************************************
  492. validate1 - info used when validating a user online.
  493. validate2 - there are two files so you can set two different types of user
  494.             validation files.
  495.           - if these files do not exist in your BBS directory then you will
  496.             not be able to validate users while they are online.
  497.           - these files MUST have the following format:
  498.  
  499. line 1  - put a Y or a N here to indicate whether the user will have access
  500.            to the online games.
  501. line 2  - value for message read access (covers msg bases 1-32)
  502. line 3  - value for message read access (covers msg bases 33-64)
  503. line 4  - value for message write access (covers msg bases 1-32)
  504. line 5  - value for message write access (covers msg bases 33-64)
  505. line 6  - value for library upload access (covers libs 1-32)
  506. line 7  - value for library upload access (covers libs 33-64)
  507. line 8  - value for library download access (covers libs 1-32)
  508. line 9  - value for library download access (covers libs 33-64)
  509. line 10 - value for bulletin read access (covers bulletins 1-32)
  510. line 11 - value for bulletin read access (covers bulletins 33-64)
  511.  
  512. Here is an example of what my validate1 file looks like:
  513.  
  514. Y
  515. 15
  516. 0
  517. 15
  518. 0
  519. -1
  520. 33554431
  521. -1
  522. 33554431
  523. 127
  524. 0
  525.  
  526. Your validate1 and validate2 files may look different depending on how many
  527. message bases, libraries, and bulletins you have. You may wonder how to
  528. come up with the various values. These are easy to get with the use of the
  529. offline user editor program. Set up your account for the way you want the
  530. validate1 file to work. Then copy down the values beside the various items
  531. you need to set. The value may look like this in the UserEdit program:
  532.  
  533. I. Msg. Read Acces: 0/15
  534. J. Msg Write Acces: 0/15
  535. M. Upload Access  : 33554431/-1
  536. N. Dload Access   : 33554431/-1
  537. Q. Bulletin Access: 0/127
  538.  
  539. The numbers can be seen seperated by a "/". The first value represents any
  540. area from 33-64 and the second value represents areas 1-32. Use the values
  541. you wish in your validate1 and validate2 files. Please note that you do not
  542. need both validate1 and validate2. It is just that two have been included
  543. in case you need two standard ways to validate users (I use validate1 for
  544. users over age 18 and validate2 for users under age 18 so I can set the
  545. proper library areas they can and can't access).
  546.  ****************************************************************************
  547. L?.text - library descriptor file. The ? means the library number that the
  548.           text file coincides with (ie. L1.text, L2.text, etc.). You may
  549.           want to write a small description of what each library is used
  550.           for. This way people may get a better understanding of what that
  551.           specific library will hold. The text file(s) are not mandatory.
  552.           If the BBS can not find it then it will bypass it without any
  553.           problems. If you do decide to make text files, then they MUST
  554.           be located in the Libraries dir of the main BBS dir (where you
  555.           will also find the L-1, L-2, 1.list, 2.list, and so on files).
  556. ******************************************************************************
  557. Using The Doors Games:
  558. ---------------------
  559. To make use of any of the games or whatever that will be coming out for
  560. TeleFun BBS, you must have a directory named DOORS assigned to someplace.
  561. All games will operate out of this directory. Full details on how to set
  562. up each game will be included with the game.
  563. To be able to have the games appear in the menu, you will need to create
  564. a text file in the main BBS directory. This text file will be called
  565. Door.games and it will look something like this:
  566.  
  567. 1
  568. Land Quest
  569. Doors:LandQuest/LandQuest
  570.  
  571. The first line is the game number for use in the BBS. Just number your games
  572. starting at one and going on from there. The second line is the name of the
  573. game as you would see it. The third line is the exact pathname used for
  574. running the game (the same as you would type in if running from the CLI).
  575. ******************************************************************************
  576. Commands Required In C Directory:
  577. --------------------------------
  578. The following commands are required by the BBS in your c directory. Please
  579. ensure they are there:
  580.  
  581. copy
  582. delete
  583. execute
  584. filenote
  585. join
  586. list
  587.  
  588. Future Plans for TeleFun_BBS:
  589. ----------------------------
  590. 1. The whole BBS is currently being rewritten in C (SAS/C version 6.5 to
  591.    be exact). This means some major changes will be coming.
  592.  
  593. 2. Create an interface for more games to be added. Maybe even to allow the
  594.    use of games already written for BBS programs like Tag, Paragon, Metro,
  595.    and any others I can't think of right now.
  596.  
  597. 3. Do you want control over what colors are used where? In other words, do
  598.    you want the ability to be able to pick and choose the colors you use or
  599.    would you rather me leave it hard coded in as it is now?
  600.  
  601. 4. I'm still looking for more ideas from all you folks out there. Even if
  602.    you are not running TeleFun_BBS but you have an idea of what you would
  603.    like to see in a BBS program then drop me a line.
  604.  
  605. ******************************************************************************
  606. TeleFun_BBS Bug Report:
  607. ----------------------
  608. Please use the following form when you are reporting problems with TeleFun_BBS
  609. since this will help me identify where I went wrong a little easier.
  610.  
  611. YOUR ACCOUNT NUMBER ON BLACK BOX BBS IF APPLICABLE :______________
  612.  
  613. NAME :__________________________________                 TODAY'S DATE
  614.  
  615. ADDRESS :_______________________________              __________________
  616.  
  617.          _______________________________
  618.  
  619.          _______________________________
  620.  
  621. PHONE (if you want) :_______________________
  622.  
  623. BBS NAME :__________________________________
  624.  
  625. BBS PHONE :_________________________________
  626.  
  627. Computer Setup (try to be VERY detailed) :___________________________________
  628.  
  629. _____________________________________________________________________________
  630.  
  631. _____________________________________________________________________________
  632.  
  633. What sort of requestor appeared?
  634.  
  635. _____________________________________________________________________________
  636.  
  637. _____________________________________________________________________________
  638.  
  639. _____________________________________________________________________________
  640.  
  641. What error number/description was displayed? ________________________________
  642.  
  643. What was happening on the BBS at the time of the error?
  644.  
  645. _____________________________________________________________________________
  646.  
  647. _____________________________________________________________________________
  648.  
  649. _____________________________________________________________________________
  650.  
  651. _____________________________________________________________________________
  652.  
  653. _____________________________________________________________________________
  654.  
  655. Did this happen more than once?_________________ How often?__________________
  656.  
  657. If you want to help out even further, you can do so by capturing what the
  658. screen looked like when the system bombed. Use any screen capture program
  659. and stick that IFF picture on a disk along with a copy of the version of
  660. TeleFun_BBS that you are currently using and any text file that you wish
  661. to explain what the error was. Then mail that disk to me. In return I will
  662. try to resolve that error and put the newest version of TeleFun_BBS on your
  663. disk and mail it back to you. Please enclose $1 or $2 to help cover the cost
  664. of mailing the disk to you. This applies to registered users only.
  665. *****************************************************************************
  666.  
  667. Registering Your Copy of TeleFun_BBS:
  668. ------------------------------------
  669. If you wish to register your copy of TeleFun_BBS then please send the
  670. registration form and $50 (no personal cheques please) to:
  671.  
  672.               Lawrence McClafferty
  673.               Upper Second Road,
  674.               RR #5 Trenton,
  675.               Ontario
  676.               Canada
  677.               K8V 5P8
  678.  
  679. If you include an extra $5 you will receive the latest version of TeleFun_BBS
  680. on disk. Please allow a few weeks for delivery. Once you are registered you
  681. can obtain any updates from The Black Box BBS at (613) 394-0651.
  682.  
  683. The Black Box BBS - home of the TeleFun_BBS software.
  684.                   - currently running on an - Amiga 2000 Tower 68030
  685.                                             - 1.05 gigs hard drive storage
  686.                                             - 5 megs memory
  687.                                             - Supra FaxModem 288 v.FC.
  688.  
  689. History:
  690. -------
  691. Version 1.00 - January 19, 1993
  692.              - initial release of TeleFun_BBS
  693.  
  694. Version 1.01 - January 23, 1993
  695.              - fixed "New Files" option in library
  696.              - modified message base area to try eliminating seek errors
  697.  
  698. Version 1.02 - January 27, 1993
  699.              - some minor cosmetic changes
  700.              - modification to the way messages are saved. Message length
  701.                is now a max of 99 lines instead of only 30. You MUST run
  702.                TeleFun_Setup version 1.01 (or higher) to reconfigure the
  703.                message base area BEFORE changing from TeleFun_BBS 1.01 to
  704.                1.02.
  705.              - added new feature to message bases. Now you can "Photocopy"
  706.                a message to any number of users. This means you can send
  707.                a duplicate of the message without the need for typing the
  708.                message in all over again.
  709.  
  710. Version 1.03 - February 25, 1993
  711.              - small tweak to the message base area (was still getting seek
  712.                errors).
  713.              - added "review last 50 uploads" option to library.
  714.  
  715. Version 1.04 - May 11, 1993
  716.              - added personal mail check at logon.
  717.              - attempted to fix message editor.
  718.  
  719. Version 1.05 - May 31, 1993
  720.              - needed another tweak in the message editor section.
  721.              - midnight maintenance will wait until user has finished now
  722.                instead of kicking them off at midnight.
  723.              - executes a script file set by Sysop now so more stuff can
  724.                be done during the mignight maintenance.
  725.              - added ability to validate user while that user is online (see
  726.                docs above).
  727.  
  728. Version 1.06 - June 21, 1993
  729.              - added ability to print message out to the printer if the user
  730.                has SYSOP access and it is a local logon and the printer log
  731.                file is NOT turned on.
  732.  
  733. Version 1.07 - June 28, 1993
  734.              - added ability for Sysop to turn on printer while in chat mode
  735.                so a user could dump something straight out there.
  736.              - removed printer log and disk log stuff (was really only in for
  737.                the initial bug swatting process anyway).
  738.  
  739. Version 1.08 - July 31, 1993
  740.              - some minor tweaks done in message base read functions.
  741.              - spaced out menu options in Sysop menu for easier reading.
  742.              - took out pause when reading Welcome.Text at logon.
  743.              - fixed up delay at start of each line when writing messages.
  744.              - fixed "missing library files" bug.
  745.  
  746. Version 1.09 - August 1, 1993
  747.              - added ability for Sysop to import a disk text file as a msg.
  748.  
  749. Version 1.10 - August 16, 1993
  750.              - did some work in the message base area to make things a little
  751.                more effecient.
  752.              - did some work in the library area to make things a little
  753.                more efficient.
  754.              - started adding abilitiy for boldface, underlined, and italic
  755.                text.
  756.  
  757. Version 1.11 - November 2, 1993
  758.              - some minor cosmetic work in the msg base area and libs.
  759.  
  760. Version 1.13 - December 2, 1993 (Oops, guess I missed version 1.12)
  761.              - fixed bug in online validator, now you can successfully
  762.                validate new users while they are online.
  763.  
  764. Version 1.14 - December 14, 1993
  765.              - added library description capability, can have a small
  766.                text file on disk describing each library that the user
  767.                goes into. See Text Files Required above for more info.
  768.              - added ability to logoff directly from the libraries and
  769.                the message bases without the need for returning to the
  770.                main BBS menu first.
  771.              - started adding door game interface stuff.
  772.              - when looking for a specific file in the libraries, the
  773.                BBS will also search the description of the file as well
  774.                as the name of the file if you enter at least 3 characters
  775.                of the filename or description.
  776.              - a few more cosmetic tweaks to fine tune things.
  777.  
  778. Version 1.15 - December 19, 1993
  779.              - added message auto-deletion. Msgs will now automatically be
  780.                deleted to make room for new mail. A msg can be "locked" to
  781.                prevent its being deleted though.
  782.              - added ability to download a list of files from each library.
  783.  
  784. Version 1.16 - December 29, 1993
  785.              - attempted to fix uploads/downloads for systems not using a
  786.                high speed modem.
  787.  
  788. Version 1.17 - January 1, 1994
  789.              - finally fixed the message bug.
  790.  
  791. Version 1.18 - January 4, 1994
  792.              - user has choice of plain text list or archived (using LHA)
  793.                text list when receiving a file list in the libs.
  794.              - put pause back in when showing Welcome.Text at logon.
  795.              - fixed two bugs; one in chat mode, second in msg writing area.
  796.                If user entered line longer than 75 characters with no spaces
  797.                in that line, system would go into endless loop. Now system
  798.                will set that line to a length of 75 characters.
  799.  
  800. Version 1.19 - January 10, 1994
  801.              - added the wall. To use the wall you MUST first make a subdir
  802.                in the main BBS dir and call it Wall.
  803.  
  804. Version 1.20 - February 8, 1994
  805.              - changed the way the modem answers the call. The BBS will send
  806.                out the ATA command when it senses a ring now so you MUST
  807.                remove any reference to S0=1 in your data file located in the
  808.                s directory.
  809.              - made the menu choices in the games "hot key" so user can
  810.                make choices faster.
  811.              - user's account for upload credit is not done until the file
  812.                is validated now.
  813.  
  814. Version 1.21 - March 4, 1994
  815.              - added ability to download ALL or NEW scribbles from the wall
  816.                so the user can read them offline if they wish.
  817.              - added ability to download all NEW messages from message bases
  818.                that the user has access to.
  819.              - paying members now get to download twice as many files per day
  820.                as non-paying members do.
  821.  
  822. Versions 1.22 - 1.23 - minor bugs squashed.
  823.  
  824. Version 1.24 - July 18, 1994
  825.              - added ability for higher high-speed modems (28.8k).
  826.  
  827. Version 1.25 - October 19, 1994
  828.              - added check for number of users feature and check number of
  829.                unvalidated users feature to run at midnight maintenance.
  830.  
  831. Version 1.26 - November 6, 1994
  832.              - added Caller ID capability. The BBS will keep a log file of all
  833.                the calls that come if you are using a modem that supports the
  834.                Caller ID feature. At the moment ths feature has only been run
  835.                with a Supra modem that has caller id. To set the Caller ID to
  836.                active with the Supra, you need to add CID#=1 to your init
  837.                string. When the modem detects the first RING, the modem will
  838.                pick up the phone and hang it back up right away. This is how
  839.                the modem gets its info. That info is then passed to the BBS
  840.                and is written out to a file called "Caller_ID" located in your
  841.                BBS directory. The modem will then detect the second RING and
  842.                pick up the phone normally. The person calling in will see the
  843.                message "Your call is comin in from ....." where .... will be
  844.                either the caller's phone number or the message "an unknown
  845.                number". The "unknown number" message will appear if:
  846.                a. Caller ID has not been activated on your modem or if your
  847.                   modem does not support Caller ID.
  848.                b. The call is coming in long distance and your phone company
  849.                   does not handle the display of long distance numbers yet.
  850.                c. A call came in while the BBS was still resetting itself and
  851.                   the modem so it wasn't ready to grab the info.
  852.                At this time, the Caller_ID file is only accessible from the
  853.                Shell and not from within the BBS itself. You can use any text
  854.                editor to read it. The only way to delete the file is also from
  855.                the Shell. This will all change in future versions of the BBS.
  856.                Some people may want to add a script to their midnight maint
  857.                file that will copy the Caller_ID file to some location so they
  858.                can keep a copy for future references.
  859.  
  860. Version 1.27 - November 14,1994
  861.              - reason for chat request gets written out to Sysop_News file so
  862.                Sysop can keep track of why people wanted to chat in case they
  863.                feel it may have been important and the user didn't leave mail.
  864.  
  865. Version 1.28 - December 4, 1994
  866.              - fixed message auto-delete. It wasn't working right.
  867.              - fixed ability to lock messages from auto-deletion.
  868.              - fixed message edit function.
  869.              - added ability to use TAB key when writing a message.
  870.  
  871. Version 1.29 - December 23, 1994
  872.              - added ability to attach a file to a message so user can dload
  873.                the file after reading the message.
  874.  
  875. Version 1.30 - January 14, 1995
  876.              - added ability to view the contents of the .LHA and .LZH
  877.                archives.
  878.              - added message counter to show which message number out of
  879.                how many messages you are reading.
  880.              - did some minor cosmetic changes.
  881.  
  882. Version 1.31 - January 15, 1995
  883.              - added quick message scan.
  884.  
  885. Version 1.32 - February 1, 1995
  886.              - added 3 items to menu when waiting for caller. They are:
  887.                5 - M Off => you can turn the modem off without the need
  888.                             for shutting down the BBS. Comes in handy when
  889.                             you want to load up your terminal program to
  890.                             place a call so you don't have to shut down and
  891.                             reload the BBS. Handy when used with option 6
  892.                             (see below).
  893.                6 - M On  => you can turn the modem back on. Need I say more?
  894.                7 - Sleep => makes the BBS go to sleep until you hit the RETURN
  895.                             key. Since GFA-Basic is sort of a CPU hog, there
  896.                             are times you don't want the BBS to slow down
  897.                             something you need to do temporarily. Now you can
  898.                             put the BBS to sleep, go do your thing, and then
  899.                             come back to the BBS window, click once in the
  900.                             Options window to activate it, and then hit RETURN
  901.                             to wake the BBS back up. No need to shut down the
  902.                             BBS to gain a bit of speed for those times you
  903.                             really need it.
  904.              - fixed the bug in the Caller ID that was showing the wrong
  905.                number for incoming long distance calls.
  906.              - fixed bug that would crash system if someone bet too big of a
  907.                number in any of the games.
  908.  
  909. Version 1.33 - March 1, 1995
  910.              - fixed a bug that was causing a crash some times in the libs.
  911.  
  912. Version 1.34 - March 4, 1995 (happy birthday to me)
  913.              - fixed the "Update User's Account" when validating files in
  914.                the libraries now.
  915. Version 1.35 - August 8,1995
  916.              - disabled the "Update User's Account" when validating files
  917.                since it is still not working properly. I will get it fixed
  918.                when I rewrite the whole thing in C.
  919.              - this is the last update that will be done until the C version
  920.                comes out (hopefully later this fall of 1995).
  921.  
  922. Known Bugs:
  923. ----------
  924. The following is a list of the bugs that I already know about. They are
  925. currently being worked on and will be fixed as soon as I find out what is
  926. causing them. Let's hope this list stays small (grin).
  927.  
  928. - some people have reported bugs in the file transfer area of the program.
  929.   I have confirmed that there is a bit of trouble here and there. It almost
  930.   appears as though file transfers will not work properly under Workbench
  931.   1.3 but they are working fine under 2.04 and up. Also, people have had a
  932.   problem doing file transfers when operating with a normal 2400 baud modem.
  933.   My beta tester is running TeleFun using a stock Amiga 2000 with a Supra
  934.   2400 baud external modem. He uses the default initialization string for
  935.   the modem and he has his baud rate set for 2400 in preferences and a buffer
  936.   size of 8192 and a handshaking of none and he has file transfers working
  937.   with no problems so just play around with those settings. Also, for you
  938.   high speed modem users, MAKE SURE you set the "lock DTE rate to on.
  939.  
  940. - people report that the system dies during library stuff. This could be
  941.   caused by having a complete pathname longer than 30 characters. This is
  942.   NOT a fault in the BBS program. It is a limitation of GFA-Basic which I
  943.   can do nothing about. Make sure your pathnames are shorter than 30 chars.
  944.   At times, the BBS may die with an error 111 after a file transfer. I have
  945.   not quite narrowed it down to why this happens but it does not happen very
  946.   often (it happened on my system maybe 3 times in 6 months).
  947.  
  948. - to update the number of files and the score of a user when they upload a
  949.   file, you must do it manually for now. The BBS was crashing when it was
  950.   done automatically for some reason. To do this, find out how many files
  951.   and the number of kilobytes of the files and update the user's account
  952.   through the offline user editor. Sorry for this problem but it will get
  953.   fixed when I release the C version of the BBS.
  954.  
  955. - the access to AmigaDOS from the Sysop menu is not fully bug free. There
  956.   are many things you can do like copy files between directories and such
  957.   but many things are not yet supported. If you try to CD to a new directory
  958.   for instance then you just might crash. Use the AmigaDOS function very
  959.   carefully to avoid crashes.
  960.  
  961. - edditting a user's account from the Sysop menu will cause a crash as well.
  962.   I think this problem is in the same area as when trying to update a user's
  963.   account when validating files so do NOT use the user account editor from
  964.   the Sysop menu for now. It will be fixed when the C version comes out.
  965.  
  966. Modem Strings:
  967. -------------
  968. I have run TeleFun BBS with a USRobotics Courier HST modem and a Supra
  969. FaxModem with no problems. Below I will keep a list of the initialization
  970. strings used with various modems just in case you have troubles. If other
  971. people send me their modem init. strings, I will include those as well.
  972.  
  973. Supra 2400 : ATE0M0
  974.  
  975. USRobotics Courier HST : ATE0M0&B1
  976.  
  977. Supra FaxModem 14.4 v.32 bis : ATE0M0W2  (for caller id use ATE0M0W2#CID=1)
  978.  
  979. Supra FaxModem 288 v.FC : ATE0M0W2  (for caller id use ATE0M0W2#CID=1)
  980.  
  981. Things For The Future:
  982. ---------------------
  983. There are many plans in the works for the TeleFun BBS program. I am currently
  984. teaching myself C (using SAS/C 6.50). The BBS will be completely redone in C
  985. some time next year. When that happens you can expect more online games to be
  986. able to be used. Also, I am planning on adding netmail stuff to the BBS. This
  987. may not show up until near the fall of '95 though. If my C stuff really starts
  988. to come along then I will even see about maybe making the program handle
  989. multi-lines. I may even get around to buying myself one of the Planet Connect
  990. satellite systems and get that all worked into the BBS too (if I get enough
  991. people to register for the BBS to cover my cost for the system that is). Any
  992. other ideas will come from you so don't hesitate about making suggestions.
  993.